home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / mb1309.zip / MB1309.EXE / SERVER.DOC < prev    next >
Text File  |  1992-02-17  |  7KB  |  249 lines
  1.  
  2.  
  3.      Server operation: Automatic Export/Import of messages.
  4.  
  5.  
  6. The file SERVER.MB contains information that drives the automatic
  7. Export/Import of messages. If the file does not exist, no Export/Import is done.
  8.  
  9. There are two types of server; "simple" and "complex".
  10. The information required in SERVER.MB, and the type of processing done,
  11. is slightly different for each type.
  12.  
  13.  
  14.    Simple Server:
  15.  
  16.  
  17. A simple server first checks for messages to export. If there are
  18. none, it does nothing. If there were messages to export, it exports them,
  19. and runs the server process. If the server process completes normally,
  20. then an import is done. If the server process does not complete normally,
  21. no import is done. A line like the one below, placed into SERVER.MB, is
  22. all that is required to define a simple server.
  23.  
  24. S SNAME SNAME.EXE SNAME.OUT fmt SNAME.IN fmt
  25.  
  26. "SNAME" is the name of the server. Messages addressed to SNAME or SNAME @ SYSOP
  27. will be processed. SNAME.EXE is the name of the server program to execute.
  28. If the server executable has extension EXE or COM, COMMAND.COM is not loaded.
  29. If the server executable has extension BAT, then COMMAND.COM will be loaded,
  30. and about 23k more memory will be required.
  31.  
  32. To activate the "echo" server, which reads file ECHO.OUT and
  33. creates file ECHO.IN, with ECHO.EXE in directory \MB :
  34.  
  35. S ECHO \MB\ECHO.EXE ECHO.OUT H8 ECHO.IN H8
  36.  
  37.  
  38.  
  39.    Complex Server:
  40.  
  41. A complex server first exports any messages that match the designators in
  42. the designaotor list. Then the server process is run. Then any generated
  43. messages are imported. Note that, unlike a simple server, all three functions
  44. always take place. Thus a complex server can function (for example) to
  45. transfer messages both ways between the MailBox and smtp.
  46. A list like the one below, placed into SERVER.MB, is required to define a
  47. complex server. If the server file extension is EXE or COM, then COMMAND.COM
  48. is not loaded. If the server file extension is BAT, then COMMAND.COM is
  49. loaded, and you must take it's memory requirement into account.
  50.  
  51.  
  52. C SNAME SNAME.EXE SNAME.OUT fmt SNAME.IN fmt
  53. list
  54. *** EOF
  55.  
  56. Messages will be processed acording to the list, just as in FWD.MB.
  57.  
  58.  
  59.  
  60.       Export, Import, and Execute, with no Server process.
  61.  
  62.  
  63.    Export Only:
  64.  
  65.  
  66. O FILE.OUT fmt
  67. list
  68. *** EOF
  69.  
  70.  
  71.    Import Only:
  72.  
  73.  
  74. I FILE.IN fmt
  75.  
  76.  
  77.    Execute Only:
  78.  
  79.  
  80. ! FILE
  81.  
  82.  
  83.       Summary of list types within SERVER.MB
  84.  
  85.  
  86. Item    Function
  87.  
  88. C  "Activate a Complex server"
  89. I  "Input from File"
  90. O  "Output to File"
  91. S  "Activate a Simple server"
  92. !  "Run program or batch file"
  93.  
  94.  
  95.  
  96. Available format modifiers are:
  97.  
  98. O - Use the old style "standard" (WA7MBL) export/import format.
  99. 8 - Use RFC-822 headers.
  100. H - Include the BBS message headers.
  101.  
  102. If no modifier is given, then ONLY the message text is put into the file.
  103.  
  104. To Export messages TO the file MSG.OUT in old (WA7MBL) format :
  105.  
  106. O MSG.OUT O
  107. WA6XXX
  108. *** EOF
  109.  
  110. To Export messages TO the file MSG.OUT, with only RFC-822 headers
  111. and message text, (as might be used by a user written smtp interface):
  112.  
  113. O MSG.OUT 8
  114. WA6XXX
  115. *** EOF
  116.  
  117. To Export messages TO the file MSG.OUT,
  118. with RFC-822 headers, existing BBS headers, and message text :
  119.  
  120. O MSG.OUT H8
  121. WA6XXX
  122. *** EOF
  123.  
  124. To Export messages TO the file MSG.OUT, with only the message text :
  125.  
  126. O MSG.OUT
  127. WA6XXX
  128. *** EOF
  129.  
  130.  
  131. To Import messages FROM the file MSG.IN, which is in "standard" format :
  132.  
  133. I MSG.IN O
  134.  
  135.  
  136.  
  137.      DOS commands.
  138.  
  139. A "!" list is a program or batch file to run. A file extension must be given.
  140. If the extension is BAT, the window size must be large enough for COMMAND.COM
  141. as well as the largest program run from the batch file.
  142.  
  143.  
  144.      Example:
  145.  
  146. ! CLOCK.BAT
  147.  
  148. This will run CLOCK.BAT, which can do multiple DOS commands.
  149.  
  150. ! CLOCK.EXE
  151.  
  152. This will load and run CLOCK.EXE
  153.  
  154.  
  155.       Wildcards and special "callsigns" in lists.
  156.  
  157.  
  158. See WILD.DOC for a description of how to use wildcard characters.
  159.  
  160.  
  161.       Sublists.
  162.  
  163. At any place in the SERVER.MB file you can refer to another file.
  164. What happens is that the contents of the sublist are treated exactly
  165. as if they were in the SERVER.MB file. A sublist is given by a line
  166. starting with "@". The rest of the line is the device, path, and file
  167. name of the sublist file.
  168.  
  169.  
  170.  
  171.      File formats.
  172.  
  173. The following is an example export file produced using format H8.
  174.  
  175. Things to note about this file:
  176.  
  177. 1. There is a blank line following the RFC-822 header, and another
  178.    following the MailBox header.
  179.  
  180. 2. The special header item "X-msgtype" is used to show whether the
  181.    message is a Bullletin, is Personal, or is an NTS message.
  182.  
  183. 3. The special header item "X-BID" is used to show the BID,
  184.    if the message has one.
  185.  
  186. 4. The file can contain multiple messages.
  187.  
  188.  
  189. Date: 12 Mar 89 17:09           <- Date at originating MailBox
  190. Message-ID: <8988@N6IYA>       <- Message number at orig MailBox
  191. X-msgtype: P               <- Message type (B, P, T)
  192. X-BID: 1234_N6IYA           <- BID, if the message has one.
  193. From: N6IYA@N6IYA           <- User at orig MailBox
  194. To: ECHO@W0RLI.OR.USA.NA       <- Full location as sent
  195. Subject: Testing path turnaround.  <- Message title
  196.                    <- Blank between RFC-822 hdr and MailBox hdrs
  197. R:890312/1722z @:W0RLI.OR.USA.NA West Linn #:3571 Z:97068
  198. R:890312/1709z @:N6IYA.CA.USA.NA Felton #:8988 Z:95008
  199.                    <- Blank between MailBox hdrs and text.
  200. Test message.               <- Message text.
  201. ../EX                   <- ".." added, not there in actual format
  202.  
  203.  
  204.  
  205.  
  206. It appears that there will be a large number of servers created.
  207. These are servers I have heard about. Some are ready for use, some
  208. are in the planning/coding stage.
  209.  
  210.  
  211. ECHO   - "echo" the message back to sender for path testing.
  212.  
  213. REQDBF - Database server by K0ZXF.
  214.  
  215. FILEX  - "File eXchange". Upload, Download, directory listings.
  216. REQDIR - Request directory information.
  217.      The FILEX server handles REQDIR.
  218. REQFIL - Request a file.
  219.      The FILEX server handles REQFIL.
  220.  
  221. REQQSL - Request qsl manger info for dx callsign.
  222. REQWP  - Request WP information.
  223.      Remote access to the I, I@, IH, and IZ commands.
  224.  
  225. RLIMON - Automated sysop functions from KJ4LQ.
  226.  
  227. REQQTH - Request name/address for callsign.
  228.  
  229. REQCB  - Callbook info from the J-Comm or RT Systems databases.
  230.  
  231. SMTP   - smtp/BBS message interface.
  232.  
  233.  
  234.  
  235. Here is an example for a user-written server, using only DOS batch commands.
  236. This server will print selected messages as they arrive.
  237.  
  238. 1. In the distribution lists for any messages you want printed,
  239.    add an extra callsign PRTIT.
  240.  
  241. 2. In SERVER.MB add the lines:
  242.  
  243.    ! DEL PRTIT.OUT
  244.    O PRTIT.OUT 8
  245.    PRTIT
  246.    *** EOF
  247.    ! PRINT PRTIT.OUT
  248.  
  249.